---
type: service
title: Payments Service
description: Internal service that charges buyers, records payment attempts and publishes payment outcomes.
tags: [service]
owner: payments-team
timestamp: {{DATE}}
---
<!-- ✂ docujoint template sample — replace with your own content, then delete this comment. -->
# Payments Service

## Purpose
Owns everything money: creating charges via [Stripe](</Services/Stripe.md>),
recording attempts against [orders](</Data/main/Tables/orders.md>), and
publishing [order-placed](</Events/order-placed.md>) when a charge succeeds.
No other service talks to the payment provider directly.

## Endpoints
| Method | Path | Purpose | Auth |
|--------|------|---------|------|
| POST | /charges | Charge the buyer for a cart; idempotent by cart id | session token |
| GET | /charges/:id | Status of a charge attempt | session token |
| POST | /refunds | Refund an order, full or partial; drives the Refund Flow | internal (Backoffice SSO) |

## Features

## Open questions